@database BlueEyes.guide
@author "Volker Georg Franke"
@$VER: "BlueEyes.guide Version 1.2"
@smartwrap
@node Main "BlueEyes"
Anleitung zu @{b}BlueEyes Version 1.2@{ub} c 1995 by Smile Soft@{par}
Kleine bunte Augen f
r den AMIGA.@{par}
    @{" Einleitung " link Einleitung}@{par}
    @{" BlueEye " link Blue}@{par}
    @{" Was ist neu ? " link neu}@{par}
    @{" Installation " link Install}@{par}
    @{" Anforderungen " link Anforderungen}@{par}
    @{" ToolTypes " link ToolTypes}@{par}
    @{" KnowHow " link KnowHow}@{par}
    @{" Zukunft " link Zukunft}@{par}
    @{" Copyright " link Recht}@{par}
@endnode
@node Einleitung
@{b}Einleitung@{ub}@{par}
@{par}
BlueEyes sind kleine Augen die immer in Richtung des Mauszeigers schauen (sollten).
Wir haben es geschrieben, weil es auf dem AMIGA noch keine @{i}bunten @{ui}Augen gab und
wir welche haben wollten.@{par}
Es ist seit Version 1.1 ein Commoditie.@{par}
BlueEyes fordert seine Farben v
llig dynamisch an. Dies hat zur Folge, daa diese
@{" fast " link KnowHow} immer stimmen, auch wenn Ihr sie gar nicht eingestellt habt.@{par}
Einige Eigenschaften des Programms lassen sich 
ber @{" ToolTypes " link ToolTypes}
 steuern.@{par}
Auf ein Preference-Programm zur Einstellung der ToolType Werte haben wir bewuat verzichtet.
tte den Speicherverbrauch nur unn
tig erh
ht und wenig gebracht.@{par}
@{par}
Dank an Dirk Schmidt & Mario Gr
r Tests und Tips sowie an Sascha Aderhold f
r das
berarbeiten des Guide-Files.
@endnode
@node Blue
@{b}BlueEye@{ub}@{par}
@{par}
BlueEye ist prinzipiel da
 gleiche wie BlueEyes, nur mit einem Auge.@{par}
Alles was f
r BlueEyes gilt, gilt auch f
r BlueEye. Allerdings kann es mehrere einzelne Augen geben.@{par}
@endnode 
@node Install
@{b}Installation von BlueEyes@{ub}@{par}
@{par}
Eigentlich gibt es nichts zu Installieren. Das Programm kann einfach in WBStartup oder
einen anderen Ordner gezogen werden. Danach sollten noch die @{" ToolTypes " link ToolTypes}
 richtig gesetzt werden.@{par}
Vom CLI lassen sich keine Parameter 
bergeben. Es w
re zwar m
glich,
aber ich hatte keine Lust CLI-Argumente auszuwerten. BlueEyes ist ein Workbench-Programm
und sollte auch von dort gestartet werden.@{par}
BlueEyes hat ein NewIcon. Das NewIcon System ist 
 by Nicola Salmoria und eine wirklich
tolle Sache.
@endnode
@node neu
@{b}Was ist neu ?@{ub}@{par}
@{par}
@{b}Version 1.2a@{ub}@{par}
@{par}
   - @{" BlueEye " link Blue}@{par}
@{par}
@{b}Version 1.2@{ub}@{par}
@{par}
   - weniger Speicherverbrauch@{par}
   - Fenster wird beim Start gleich mit der Hintergrundfarbe gef
llt@{par}
@{par}
@{b}Version 1.1@{ub}@{par}
@{par}
   - BlueEyes ist nun ein Commoditie@{par}
      Dies hat viele Vorteile bei der Signalverarbeitung.@{par}
   - die Farben wurden etwas ge
ndert@{par}
   - es gibt einen neuen @{" ToolType " link ToolTypes} f
r den Augenhintergrund@{par}
   - das Programm l
t sich nun auch von der Shell starten@{par}
   - Men
s und Fehlermeldungen sind in Englisch@{par}
   - mehrere kleine Fehler wurden behoben@{par}
@endnode
@node Anforderungen
@{b}Systemanforderungen@{ub}@{par}
@{par}
@{b}Das Programm ben
tigt :@{ub}@{par}
@{par}
   - einen AMIGA mit mindestens OS 3.0@{par}
   - rund 35 kByte Speicher @{par}
   - den Helvetica Font ( Gr
e 13 & 15 )@{par}
      ( nur beim Aufruf des c Requesters )@{par}
   - rund 0.1 % Prozessorleistung vom Input.device@{par}
   - rund 7 % Prozessorleistung beim Zwinkern bzw. Bewegen der Augen@{par}
   - BlueEyes ist f
r Screens mit einem Seitenverh
ltnis von 4:3 konzipiert@{par}
   - weiterhin ben
tigt BlueEyes folgende Librarys :@{par}
        commodities.library@{par}
        diskfont.library@{par}
        dos.library@{par}
        gadtools.library@{par}
        graphics.library@{par}
        intuition.library@{par}
        mathieeedoubbas.library@{par}
        mathieeedoubtrans.library@{par}
@{par}
Das Fehlen der letzten beiden Librarys kann zum Absturz f
hren, da ich deren Existens nicht testen kann.
Sie werden vom Compiler automatisch eingebunden.@{par}
@{par}
@{b}Das Programm wurde getestet auf :@{ub}@{par}
@{par}
   - A3000    OS3.1 10Mb HD Merlin GFX@{par}
   - A4000/40 OS3.0 10Mb HD Retina GFX@{par}
   - A4000/30 OS3.0  4Mb HD@{par}
   - A1200    OS3.0  2Mb HD@{par}
@{par}
@endnode
@node ToolTypes
@{b}ToolTypes von BlueEyes@{ub}@{par}
@{par}
BlueEyes unterst
tzt verschiedene ToolTypes. Falls Sie diese nicht benutzen
nimmt BlueEyes default-Werte.@{par}
@{b}XPos @{ub} (default = 400)@{par}
X-Position des Augenfensters.@{par}
@{b}YPos @{ub} (default = 1)@{par}
Y-Position des Augenfensters.@{par}
@{b}ToolPri @{ub} (default = 0)@{par}
Priorit
t des Tasks@{par}
@{b}SleepTime @{ub}@{par}
Zeit bis die Augen einschlafen in 1/10 sec. @{par}
@{b}BlinkTime @{ub} @{par}
Intervaldauer f
r das Augenzwinkern in 1/10 sec.@{par}
@{b}BackColor @{ub} (default=2)@{par}
Nummer des Registers f
r den Augenhintergrund. Dies ist besonders wichtig
falls man Tools wie z.B. Fullbench benutzt oder die Augen 
ber einem 
Workbenchhintergrund platzieren m
chte.@{par}
@{b}Locked @{ub} (default = yes)@{par}
no  = das Fenster l
t sich verschieben @{par}
yes = das Fenster l
t sich nicht verschieben@{par}
NO hat den Vorteil, daa es beim (de-)Aktivieren nicht zu Graphikfehlern kommt.@{par}
Die Commodore Standart ToolTypes f
r Commodities werden nicht unterst
tzt !@{par}
@endnode
@node KnowHow
@{b}KnowHow@{ub}@{par}
@{par}
Mausverfolgende Augen f
r den AMIGA gibt es schon viele. Ich fand diese aber alle recht farblos.
Wer MyEyes auf dem MAC gesehen hat, weia was ich meine.@{par}
Der Trick bei BlueEyes besteht in der dynamischen Umordnung der Farbregister zur Laufzeit. Die
Bilder f
r die Augendarstellung sind als Planar-Bild gespeichert. Beim Start des Programms
wird mit der Funktion ObtainBestPenA() des Betriebssystems (ab OS3.0) festgestellt, in welchem 
Register sich die ben
tigte (oder eine 
hnliche) Farbe befindet. Die eigentliche Farbzuordnung im
Bild wird dann durch das neue Register ersetzt und so passen sich die Augen immer der aktuellen
Palette an. Da das Registertauschen  bei Planar-Bitplanes relativ lange dauert und aufwendig ist,
wird das Bild zuvor in ein Chunky-Bild umgerechnet. Hier werden die Farbregister
getauscht und dann wird das Bild wieder zu einem Planar-Bild gemacht.@{par}
Hieraus resultiert die kurze Pause beim starten des Programms.@{par}
Probleme mit der Farbzuordnung gibt es nur bei zu wenigen (freien) Farbregistern (<16).
Hier versagt die beste Palettenverwaltung und es kommt auch bei BlueEyes zu Farbfehlern.
Diese zeigen sich dann besonders beim Zwinkern. Falls die Augen also h
lich aussehen braucht
Ihr mehr Farben f
r die Workbench. Die von BlueEyes belegten Farbregister stehen anderen
Programmen nach wie vor zur Verf
gung.@{par}
Das Programm wurde in C geschrieben und mit Maxon C++ compiliert. Die Routinen zur 
Bildkonvertierung sind in Assembler geschrieben.
@endnode
@node Recht
@{b}Rechtliches@{par}
@{par}
Das Program BlueEyes ist Copyright 1995 by Rene Brothuhn & Volker Georg Franke@{ub}@{par}
@{par}
Diese Dokumentation und das Programm d
rfen frei kopiert und weitergegeben werden, solange
die Copyright-Notiz unver
ndert auf allen Kopien enthalten bleibt. Es wird keine Garantie
r die fehlerfreie Funktion des Programms 
bernommen. Wir 
bernehmen keine Haftung f
irgendwelche Sch
Das Programm BlueEyes ist "freely distributable", aber das Copyright liegt
weiterhin bei Rene Brothuhn und Volker Georg Franke.@{par}
BlueEyes darf in Public-Domain Sammlungen, Mailboxsystemen oder auf FTP Servern nur
zusammen mit dieser Anleitung abgelegt werden.@{par}
Das Programm darf ohne eine schriftliche Genehmigung der Autoren nicht zu kommerziellen
Zwecken benutzt werden.@{par}
Bugs, Kritik und W
nsche sendet bitte an :@{par}
@{par}
   Volker Georg Franke@{par}
   Stolberger Stra
e 70@{par}
   99734 Nordhausen@{par}
@{par}
   oder :@{par}
@{par}
   Rene Brothuhn@{par}
   Yorckstra
e 2@{par}
   99734 Nordhausen@{par}
@{par}
   email: "vgfranke@informatik.tu-clausthal.de"@{par}
   oder   "CRUSH@DELTA.HMS.MCNET.DE"@{par}
@{par}
Wir freuen uns 
ber jede Reaktion auf unser Programm!@{par}
@{par}
Nordhausen, Oktober 1995
@endnode
@node Zukunft
@{b}Zukunft@{ub}@{par}
@{par}
Wir haben noch ein paar Verbesserungen f
r BlueEyes geplant.@{par}
@{par}
   - Die Augen sollen auch beim Zwinkern in Richtung Maus schauen.@{par}
   - Sounds sollen 
ber einen Port zu UPD gesendet werden.@{par}
   - Das Geflimmere beim Pupillenmalen sollte entfallen.@{par}
   - ToolType f
r Pupillenfarbe@{par}
   - Das Verhalten der Augen mua verbessert werden.@{par}
   - Vielleicht doch ein Prefs-Programm?@{par}
@{par}
Wann und wie schnell diese Funktionen implenentiert werden wissen wir noch nicht, aber
wir arbeiten daran. F
r Kritik und weitere Vorschl
ge sind @{" wir " link Recht} 
rlich dankbar.
@endnode